
<html><HEAD>
<LINK REL=STYLESHEET HREF="default.css" TYPE="text/css">
<TITLE>
Positioning controls in a DataWindow object</TITLE>
</HEAD>
<BODY>

<!-- Header -->
<p class="ancestor" align="right"><A HREF="pbugp184.htm">Previous</A>&nbsp;&nbsp;<A HREF="pbugp186.htm" >Next</A>
<!-- End Header -->
<A NAME="CAIDIAEE"></A><h1>Positioning controls in a DataWindow object</h1>
<A NAME="TI6155"></A><p><A HREF="pbugp185.htm#BABBIEAA">Table 20-3</A> shows
the properties for each control in a DataWindow object that determine how
it is positioned within the DataWindow object.</p>
<A NAME="BABBIEAA"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><caption>Table 20-3: Position properties for controls
in a DataWindow object</caption>
<tr><th  rowspan="1"  ><A NAME="TI6156"></A>Property</th>
<th  rowspan="1"  ><A NAME="TI6157"></A>Meaning</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI6158"></A>Background</td>
<td  rowspan="1"  ><A NAME="TI6159"></A>Control is behind other controls. It
is not restricted to one band. This is useful for adding a watermark
(such as the word CONFIDENTIAL) to the background of a report.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI6160"></A>Band</td>
<td  rowspan="1"  ><A NAME="TI6161"></A>Control is placed within one band. It
cannot extend beyond the band's border.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI6162"></A>Foreground</td>
<td  rowspan="1"  ><A NAME="TI6163"></A>Control is in front of other controls.
It is not restricted to one band.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI6164"></A>Moveable</td>
<td  rowspan="1"  ><A NAME="TI6165"></A>Control can be moved at runtime and in
preview. This is useful for designing layout.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI6166"></A>Resizable</td>
<td  rowspan="1"  ><A NAME="TI6167"></A>Control can be resized at runtime and
in preview. This is useful for designing layout.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI6168"></A>HideSnaked</td>
<td  rowspan="1"  ><A NAME="TI6169"></A>Control appears only in the first column
on the page; in subsequent columns the control does not appear.
This is only for newspaper columns, where the entire DataWindow object snakes
from column to column (set on the General page of the Properties
view).</td>
</tr>
</table>
<A NAME="TI6170"></A><h4>Default positioning</h4>
<A NAME="TI6171"></A><p>PowerBuilder uses the defaults shown in <A HREF="pbugp185.htm#BABDCGEJ">Table 20-4</A> when you place
a new control in a DataWindow object.</p>
<A NAME="BABDCGEJ"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><caption>Table 20-4: Default position properties for
controls in a DataWindow object</caption>
<tr><th  rowspan="1"  ><A NAME="TI6172"></A>Control</th>
<th  rowspan="1"  ><A NAME="TI6173"></A>Default positioning</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI6174"></A>Graph</td>
<td  rowspan="1"  ><A NAME="TI6175"></A>Foreground, movable, resizable</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI6176"></A>All other controls</td>
<td  rowspan="1"  ><A NAME="TI6177"></A>Band, not movable, not resizable</td>
</tr>
</table>
<A NAME="TI6178"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To change the position of a control in a DataWindow object:</p>
<ol><li class=fi><p>Select Properties from the control's
pop-up menu and then select the Position tab.</p></li>
<li class=ds><p>From the Layer option drop-down list, select Background,
Band, or Foreground.</p></li>
<li class=ds><p>Select Resizable or Moveable as appropriate.</p></li></ol>
<br>
